5 cửa ải đứng giữa bạn và AI Crypto Trading
OKX MCP đã có sẵn — nhưng cài đúng cách để Claude "nhìn thấy" nó là cả một hành trình:
📦 #1 — Cài Node.js
npm dùng Node, không phải Python. Bản LTS hay Current? PATH đã đúng chưa?
🔑 #2 — Tạo API key OKX
DEMO hay LIVE? Sub-account hay main? Passphrase ở đâu? IP whitelist?
📝 #3 — Sửa config.toml
File ở %USERPROFILE%\.okx\ — gõ sai 1 dòng là auth fail.
⚙️ #4 — Đăng ký MCP với Claude
Sửa claude_desktop_config.json đúng cú pháp JSON.
🔌 #5 — Lỗi Signature / 50113
Chọn nhầm DEMO/LIVE → sai signature → không biết sửa chỗ nào.
Code2trade gói tất cả vào 1_SETUP_chay_mot_lan.bat
Một file bat duy nhất tự làm hết: cài Node.js, cài okx-trade-mcp,
mở wizard popup để bạn paste API key — không phải gõ tay vào file config nào.
Wizard verify với OKX trực tiếp ngay lúc nhập, báo lỗi rõ ràng trước khi lưu.
😩 Cách thủ công
Lên nodejs.org tải Node.js LTSnpm install -g @okx_ai/okx-trade-mcpTạo thư mục %USERPROFILE%\.okx\Viết tay config.toml với api_key / secret / passphraseMở claude_desktop_config.json, thêm MCP entryRestart Claude Desktop, hy vọng không lỗi JSONLỗi 50113 → tìm hiểu DEMO/LIVE khác nhau thế nào
🚀 Với Code2trade — 3 bước
- Bước 1: Double-click 1_SETUP_chay_mot_lan.bat
- Bước 2: Đợi tự cài Node.js + OKX package (~3 phút)
- Bước 3: Wizard popup hiện ra → chọn DEMO/LIVE → paste 3 key → Test → Save
✓ Tự cài Node.js (qua winget)
✓ Tự cài okx-trade-mcp từ npm
✓ Wizard verify API key với OKX ngay khi nhập
✓ Tự ghi config.toml đúng format
✓ Tự đăng ký MCP với Claude Desktop
✓ Tạo shortcut "OKX + Claude AI" trên Desktop
🔒 Bảo mật — API key chỉ lưu local
Toàn bộ chạy local trên máy bạn. API key lưu tại %USERPROFILE%\.okx\config.toml
— không gửi đi đâu, Code2trade không thấy. Bắt đầu với tài khoản DEMO, khi sẵn sàng mới chuyển LIVE.
Khuyến nghị sub-account key chỉ có quyền Read + Trade, KHÔNG cấp quyền Withdraw.
4 bước từ tải về đến lệnh crypto đầu tiên
Làm theo đúng thứ tự. Tổng thời gian: ~5 phút (lần đầu).
1
Chuẩn bị tài khoản OKX & API key
Đăng nhập okx.com →
vào My Account → API → tạo API key mới.
Để an toàn, chọn Demo Trading trước (toggle góc trên trang OKX).
Tick quyền Read + Trade. Ghi lại API Key, Secret Key, Passphrase
— Passphrase bạn tự đặt lúc tạo, không lấy lại được.
2
Giải nén & chạy 1_SETUP_chay_mot_lan.bat
Tải file OKX-MCP-Setup.rar từ nút Download bên dưới, giải nén ra thư mục bất kỳ.
Double-click 1_SETUP_chay_mot_lan.bat.
Windows SmartScreen cảnh báo → "More info" → "Run anyway".
Script sẽ tự chạy qua 4 bước:
[1/4] Checking Claude Desktop... OK
[2/4] Checking Node.js... OK (v20.x)
[3/4] Installing okx-trade-mcp... OK
[4/4] Launching API key wizard...
3
Nhập API key vào wizard popup
Cửa sổ wizard hiện ra — không cần mở Notepad hay gõ tay vào file nào:
- Chọn DEMO hoặc LIVE
- API Key — chuỗi ~32 ký tự từ OKX
- Secret Key — chuỗi ~32 ký tự
- Passphrase — mật khẩu bạn tự đặt lúc tạo key
Bấm "Test Connection" → wizard gọi API OKX xác minh ngay. Nếu hiện
"✓ Connected" → bấm "Save & Continue".
Setup tự ghi config và đăng ký MCP với Claude Desktop. Khi thấy "CAI DAT HOAN TAT!" → xong.
4
Mở Claude Desktop & bắt đầu giao dịch
Click shortcut "OKX + Claude AI" trên Desktop (tự tạo trong setup) để mở Claude Desktop với MCP đã kết nối.
Kiểm tra bằng câu lệnh đầu tiên:
› Hiển thị số dư tài khoản OKX của tôi
→ AI trả về Balance, Equity theo từng đồng (USDT, BTC, ETH...).
Nếu AI trả về số dư → kết nối thành công. Nếu lỗi → chạy lại
0_WIZARD_doi_API_KEY.bat để kiểm tra lại key.
Lệnh mẫu — nói tiếng Việt, Claude hiểu hết
Chat trong Claude Desktop như nhắn tin thông thường. Một số lệnh thử ngay:
💼
Tài khoản
Số dư, vị thế mở, lịch sử, phí giao dịch
📊
Thị trường
Giá realtime, orderbook, nến, funding rate
⚡
Spot & Futures
Đặt lệnh market/limit, SL/TP, đóng vị thế
🤖
Grid / DCA Bot
Tạo, liệt kê, dừng bot tự động
› Giá BTC hiện tại trên OKX là bao nhiêu?
→ AI trả về Bid / Ask / Last price realtime của BTC-USDT.
› Tôi đang có position nào mở không?
→ AI liệt kê các vị thế đang mở, P&L hiện tại từng lệnh.
› Mua BTC trị giá 100 USDT theo giá thị trường
→ AI đặt spot market order BTC-USDT, xác nhận order ID và fill price.
› Mua BTC 100 USDT, đặt stop loss 84000 và take profit 95000
→ AI đặt market order kèm OCO algo: SL 84000, TP 95000.
› Mở long BTC-USDT-SWAP đòn bẩy 5x, 0.01 BTC, cross margin
→ AI thiết lập leverage rồi đặt futures market long.
› Tạo bot grid BTC-USDT từ 80000 đến 100000, 10 lưới, 100 USDT
→ AI tạo grid bot với các tham số, trả về bot ID.
› Lịch sử lệnh đã khớp 7 ngày qua
→ AI truy xuất filled orders 7 ngày, liệt kê symbol, side, size, price, P&L.
Toàn bộ tính năng sau khi setup xong
OKX Agent Trade Kit mở ra hơn 30 thao tác — từ xem giá đến bot tự động:
💼 Tài khoản & số dư
Check balance, equity, margin, lịch sử giao dịch, phí, P&L theo ngày/tuần.
📊 Dữ liệu thị trường
Giá realtime, orderbook depth, nến OHLCV mọi khung giờ, funding rate, open interest.
🛒 Spot Trading
Lệnh market, limit, IOC. Đặt Stop Loss / Take Profit dạng OCO. Hủy lệnh đơn lẻ hoặc toàn bộ.
⚡ Futures / Swap
Long/Short với đòn bẩy, cross/isolated margin. Đóng vị thế, chỉnh leverage, trailing stop.
🎲 Options
Xem option chain, Greeks (Delta, Gamma, Theta, Vega) theo expiry và strike price.
🤖 Grid & DCA Bot
Tạo grid bot với range/số lưới/vốn. Tạo DCA bot. Liệt kê và dừng bot đang chạy.
"Trước đây cứ thấy API key, config.toml là tôi bỏ cuộc. Giờ wizard tự verify ngay lúc nhập —
sai là biết ngay, đúng thì
Save một cái là xong. Lần đầu mua BTC bằng tiếng Việt
trong Claude, cảm giác lạ hẳn."
— Phản hồi từ trader sử dụng Code2trade OKX MCP
📌 Yêu cầu hệ thống
- Windows 10 / 11 64-bit
- Claude Desktop đã cài với tài khoản Claude Pro / Team — tải tại claude.ai/download
- Tài khoản OKX đã KYC + API key (DEMO hoặc LIVE)
- Node.js — không có cũng được, script tự cài qua winget
Tải gói cài đặt OKX MCP — Code2trade
Bao gồm 1_SETUP_chay_mot_lan.bat, 0_WIZARD_doi_API_KEY.bat, GUI installer · Hỗ trợ Windows 10/11
⬇ Tải xuống — OKX-MCP-Setup.rar
File .rar · Miễn phí · Cập nhật tháng 6/2026